SKILL.md 格式规范

概述

定义 AI Agent 技能文档的标准格式，包含 frontmatter 元数据和工作流正文，是 agentskills.io 开放标准的核心载体。

关键内容

• Frontmatter 关键字段：name（唯一标识符，也是斜杠命令名称）、description（Level 0 目录展示内容，是 Agent 决定是否加载技能的唯一依据）、version（语义化版本，Agent 自我改进时递增）、platforms（不匹配时技能完全隐藏）、category（Level 0 目录分类展示）、config（声明非密钥配置项，存入 config.yaml 自动注入）
• 安全配置：required_environment_variables 声明所需环境变量，技能不会因缺少它们而隐藏，首次加载时自动弹出配置提示
• 条件激活字段：fallback_for_toolsets、fallback_for_tools、requires_toolsets、requires_tools 控制技能根据工具可用性自动显示或隐藏
• 正文结构：When to Use（何时使用）→ Prerequisites（前提条件）→ Procedure（步骤）→ Rollback（回滚）→ Pitfalls（常见问题）→ Verification（验证）
• 目录结构：~/.hermes/skills/<category>/<skill-name>/SKILL.md，可包含 examples/ 和 reference/ 子目录供 Level 2 加载
• 斜杠命令映射：每个已安装的技能自动成为斜杠命令，如 /deploy-to-k8s

来源

• NousResearch/hermes-agent — 2026 年 4 月版本，Hermes Agent 深度解析第四篇

相关

• Hermes Agent — implements
• agentskills.io — implements
• 开放技能标准 — part_of
• 渐进式加载 — extends
• 条件激活机制 — extends